home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Updates / PowerPC / pdflib / doc / compatibility.txt < prev    next >
Text File  |  2000-05-16  |  3KB  |  128 lines
  1. API changes
  2. ===========
  3.  
  4. This file documents those API changes which affect
  5. existing PDFlib client programs. Although I go to
  6. some efforts in maintaining the existing API functions,
  7. it is sometimes necessary to incorporate a few non-backward
  8. compatible changes in order to streamline the API and
  9. incorporate new or extended functions.
  10.  
  11. API changes in PDFlib V2.01
  12. ===========================
  13. - PDF_place_inline_image() is no longer supported; use PDF_place_image()
  14.   instead (same interface):
  15.   Change
  16.     PDF_place_inline_image()
  17.     -- to --
  18.     PDF_place_image()
  19.  
  20. - PDF_put_image() is no longer required. Instead, the image data is
  21.   "parked" immediately on PDF_open_*():
  22.   Delete
  23.     PDF_put_image()
  24.  
  25. - PDF_execute_image() is no longer required. Instead, PDF_place_image()
  26.   can be called multiple times for a given PDF:
  27.   Change
  28.     PDF_execute_image()
  29.     -- to --
  30.     PDF_place_image()
  31.  
  32. - The interface and functionality of PDF_open_memory_image() changed:
  33.   Change
  34.     int PDF_open_memory_image(PDF *p, unsigned char *buffer,
  35.         int width, int height, int components, int bpc);
  36.     -- to --
  37.     int PDF_open_image(PDF *p, "raw", "memory", const char *data, long len,
  38.         int width, int height, int components, int bpc, NULL);
  39.  
  40.  
  41. API changes in PDFlib V2.0
  42. ==========================
  43.  
  44. - All API functions with parameters of type "char *" changed to "const char *".
  45.  
  46. - change
  47.     PDF_data_source_from_buf()
  48.     -- to --
  49.     int PDF_open_memory_image(PDF *p, unsigned char *buffer,
  50.         int width, int height, int components, int bpc)
  51. - change
  52.     PDF_set_text_matrix(PDF *p, PDF_matrix m);
  53.     -- to --
  54.     void PDF_set_text_matrix(PDF *p,
  55.         float a, float b, float c, float d, float e, float f);
  56.  
  57. - change
  58.     PDF_add_outline(p, text);
  59.     -- to --
  60.     PDF_add_bookmark(p, text, -1, 0);
  61.  
  62. - change
  63.     PDF_info *PDF_get_info(void);
  64.     -- to --
  65.     PDF_set_info(PDF *p, char *key, char *value);
  66.     (after PDF_new() and PDF_open_*())
  67.  
  68. - change
  69.     PDF_image->width and PDF_image->height
  70.     -- to --
  71.     PDF_get_image_width(PDF *p, PDF_image *image)
  72.     -- and --
  73.     PDF_get_image_height(PDF *p, PDF_image *image);
  74.  
  75. - change
  76.     PDF_info->error_handler = handler;
  77.     -- to --
  78.     PDF_new2(handler, ...);
  79.     Watch out for the changed signature of the error handler.
  80.  
  81. - change
  82.     void PDF_data_source_from_buf(*p, *src, buffer, len);
  83.     -- to --
  84.     PDF_image *PDF_open_memory_image(p, buffer, width, height, components, bpc);
  85.     void PDF_close_image(p, image);
  86.  
  87. - change
  88.     a4.width to a4_width etc.
  89.  
  90. - change
  91.     PDF_image image; /* for PDF_open_[GIF|JPEG|TIFF|memory_image] */
  92.     -- to --
  93.     int image;
  94.  
  95. - change
  96.     PDF_close_[GIF|JPEG|TIFF|memory_image];
  97.     -- to --
  98.     PDF_close_image();
  99.  
  100. - change
  101.     PDF_transition(p, type);
  102.     -- to --
  103.     PDF_transition(p, "type");
  104.  
  105. - change
  106.     PDF_set_font(p, fontname, size, encoding);
  107.     -- to  --
  108.     int PDF_findfont(p, fontname, encoding, embed);
  109.     if (font == -1)
  110.     /* handle unavailable font */
  111.     PDF_setfont(p, font, size);
  112.  
  113.     Note: the old PDF_set_font() is still available for compatibility.
  114.  
  115. - change
  116.     PDF_stringwidth(char *text);
  117.     -- to --
  118.     PDF_stringwidth(text, PDF_get_font(p), PDF_get_fontsize(p));
  119.  
  120. - change
  121.     PDF_open(filename);
  122.     -- to --
  123.     p = PDF_new();
  124.     if (PDF_open_file(filename) == -1) { ... }
  125.     -- or --
  126.     p = PDF_new();
  127.     if (PDF_open_fp(fp) == -1) { ... }
  128.